Catalogs
Create multiple catalog items.
Creates up to 1,000 items in one request, each validated as POST /catalogs would.
Each item succeeds or fails on its own, and the response is 200 either way, so always check failed. An item with an existing id or metadata not matching schema is listed there with the reason while the others are created; fix and resend only the failed items.
Request schema validation failures reject the whole request with 422, before any item is processed. Examples include more than 1,000 items, missing required fields, invalid status or schema values, non-string IDs, or metadata that is not an object. Once the request passes this validation, item-level failures are returned in failed.
POST
/
api
/
manager
/
catalogs
/
batch-create
Create multiple catalog items.
curl --request POST \
--url https://your_a2_service/api/manager/catalogs/batch-create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": {
"price": 25000
},
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
},
{
"id": "1002",
"metadata": {
"brand": "brand1",
"ext": {
"price": 18000
},
"id": "1002",
"title": "product2"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
}
]
}
'import requests
url = "https://your_a2_service/api/manager/catalogs/batch-create"
payload = { "items": [
{
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": { "price": 25000 },
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
},
{
"id": "1002",
"metadata": {
"brand": "brand1",
"ext": { "price": 18000 },
"id": "1002",
"title": "product2"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '1001',
metadata: {brand: 'brand1', ext: {price: 25000}, id: '1001', title: 'product1'},
schema: 'creative.catalog',
source: 'manual',
status: 'active'
},
{
id: '1002',
metadata: {brand: 'brand1', ext: {price: 18000}, id: '1002', title: 'product2'},
schema: 'creative.catalog',
source: 'manual',
status: 'active'
}
]
})
};
fetch('https://your_a2_service/api/manager/catalogs/batch-create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/api/manager/catalogs/batch-create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'id' => '1001',
'metadata' => [
'brand' => 'brand1',
'ext' => [
'price' => 25000
],
'id' => '1001',
'title' => 'product1'
],
'schema' => 'creative.catalog',
'source' => 'manual',
'status' => 'active'
],
[
'id' => '1002',
'metadata' => [
'brand' => 'brand1',
'ext' => [
'price' => 18000
],
'id' => '1002',
'title' => 'product2'
],
'schema' => 'creative.catalog',
'source' => 'manual',
'status' => 'active'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/api/manager/catalogs/batch-create"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/api/manager/catalogs/batch-create")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/api/manager/catalogs/batch-create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"failed": [
{
"id": "1002",
"reason": "Already exists."
}
],
"succeeded": [
{
"created_at": "2026-10-20T00:00:00Z",
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": {
"price": 25000
},
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active",
"updated_at": "2026-10-20T00:00:00Z"
}
]
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.
Body
application/json
Items to create, each shaped as the POST /catalogs body. Up to 1,000.
Maximum array length:
1000Show child attributes
Show child attributes
Was this page helpful?
⌘I
Create multiple catalog items.
curl --request POST \
--url https://your_a2_service/api/manager/catalogs/batch-create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": {
"price": 25000
},
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
},
{
"id": "1002",
"metadata": {
"brand": "brand1",
"ext": {
"price": 18000
},
"id": "1002",
"title": "product2"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
}
]
}
'import requests
url = "https://your_a2_service/api/manager/catalogs/batch-create"
payload = { "items": [
{
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": { "price": 25000 },
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
},
{
"id": "1002",
"metadata": {
"brand": "brand1",
"ext": { "price": 18000 },
"id": "1002",
"title": "product2"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '1001',
metadata: {brand: 'brand1', ext: {price: 25000}, id: '1001', title: 'product1'},
schema: 'creative.catalog',
source: 'manual',
status: 'active'
},
{
id: '1002',
metadata: {brand: 'brand1', ext: {price: 18000}, id: '1002', title: 'product2'},
schema: 'creative.catalog',
source: 'manual',
status: 'active'
}
]
})
};
fetch('https://your_a2_service/api/manager/catalogs/batch-create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/api/manager/catalogs/batch-create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'id' => '1001',
'metadata' => [
'brand' => 'brand1',
'ext' => [
'price' => 25000
],
'id' => '1001',
'title' => 'product1'
],
'schema' => 'creative.catalog',
'source' => 'manual',
'status' => 'active'
],
[
'id' => '1002',
'metadata' => [
'brand' => 'brand1',
'ext' => [
'price' => 18000
],
'id' => '1002',
'title' => 'product2'
],
'schema' => 'creative.catalog',
'source' => 'manual',
'status' => 'active'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/api/manager/catalogs/batch-create"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/api/manager/catalogs/batch-create")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/api/manager/catalogs/batch-create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"1001\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 25000\n },\n \"id\": \"1001\",\n \"title\": \"product1\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n },\n {\n \"id\": \"1002\",\n \"metadata\": {\n \"brand\": \"brand1\",\n \"ext\": {\n \"price\": 18000\n },\n \"id\": \"1002\",\n \"title\": \"product2\"\n },\n \"schema\": \"creative.catalog\",\n \"source\": \"manual\",\n \"status\": \"active\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"failed": [
{
"id": "1002",
"reason": "Already exists."
}
],
"succeeded": [
{
"created_at": "2026-10-20T00:00:00Z",
"id": "1001",
"metadata": {
"brand": "brand1",
"ext": {
"price": 25000
},
"id": "1001",
"title": "product1"
},
"schema": "creative.catalog",
"source": "manual",
"status": "active",
"updated_at": "2026-10-20T00:00:00Z"
}
]
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}